Adds a region to a window’s update region.

OSStatus InvalWindowRgn (
    WindowRef window, 
     region
);

window

A pointer to the window containing the region that you wish to be updated.

region

Set this region to specify, in local coordinates, the area to be added to the window’s update region.

function result

A result code.

DISCUSSION

The InvalWindowRgn function informs the Window Manager that an area of a window should be redrawn. The InvalWindowRgn function is similar to the InvalRgn function, but InvalWindowRgn allows the window that it operates upon to be explicitly specified, instead of operating on the current graphics port, so InvalWindowRgn does not require the graphics port to be set before its use.

See also the functions InvalWindowRect and ValidWindowRgn.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when WindowsLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by WindowsLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)